#***************************************************#
# EMMis 系统与第三方结算系统数据交换约定及存储定义  #
#***************************************************#


一、用途

    1、写客户档案和服务商（下家）档案的变动记录。
    2、写与快递业务记录直接关联的收款、付款、回款、返款等记录数据(增改删)的变动记录。
    3、接受来自第三方结算系统的与快递业务记录无关联的收款、付款、回款、返款等记录数据处理请求(增改删)，必要时更新相关结算余额。


二、在EMMis中相关联的数据表如下

    1、client_arc:客户档案，icid为唯一标识，其它唯一的字段(如客户账号、客户名称等)均不可作为客户身份识别。
    2、sp_arc:下家档案，isid为唯一标识，其它唯一的字段(如下家名称,固定批次等)均不可作为下家身份识别。
    *上述两表(建议只读)字段含义如字段名定义,系统在版本升级中可能发生字段的增加及已有字段宽度的变化,但是已有字段的名称及数据类型将不会改变。


    3、client_fee:客户收费记录，ifid为记录唯一标识，icid为关联客户外键。
    4、client_fee_r:到付/代收货款下家回款记录，ifsid为记录唯一标识，isid为关联下家外键。
    5、sp_pay:向下家付款记录，ipid为记录唯一标识，isid为关联下家外键。
    6、client_fee_c:到付/代收货款向客户返款记录，ifcid为记录唯一标识，icid为关联客户外键。

    *上述6张表为EMMis系统核心数据表，第三方系统不要直接更改其中任何数据，否则数据的一致性可能遭到无法挽回的破坏！
    *3-6表可以通过存储过程
        cp_oi_settle_add,
        cp_oi_settle_mod,
        cp_oi_settle_del,
        进行与快递业务记录无关联的结算记录的添加、修改和删除操作。存储过程定义说明见:五、六、七、
    
    7、oi_cs_arc:客户下家档案变动记录。
    8、oi_settle:与快递业务记录直接关联的收款、付款、回款、返款等记录数据的变动记录。
    *上述两表为供第三方程序直接操作的数据表。定义见:三、四、


三、oi_cs_arc字段定义
[iid] [int] IDENTITY (1, 1) NOT NULL ,	自增长记录唯一标识
[ntype] [tinyint] NOT NULL ,		结算类别，0：收款 1：回款 2：付款 3：返款
[ctype] [char] (1) NOT NULL ,		操作类别,A:添加 U:更改 D:删除
[iidcs] [int] NOT NULL ,		关联客户/下家外键
[dsysdate] [datetime] NOT NULL ,	操作发生时间,服务器本地时间
[nstate] [tinyint] NOT NULL ,		处理状态,添加时全为0
[dodate] [datetime] NULL 		处理时间,添加时全为NULL


四、oi_settle字段定义
[iid] [int] IDENTITY (1, 1) NOT NULL ,	自增长记录唯一标识
[ntype] [tinyint] NOT NULL ,		结算类别，0：收款 1：回款 2：付款 3：返款
[ctype] [char] (1) NOT NULL ,		操作类别,A:添加 U:更改 D:删除
[iidref] [int] NOT NULL ,		关联EMMis中相关表记录的唯一标识ID:ifid,ifsid,ipid,ifcid
[iidcs] [int] NOT NULL ,		关联客户(icid)/下家(isid)唯一标识	
[ddate] [datetime] NOT NULL ,		结算日期
[civcno] [varchar] (22) NOT NULL ,	发票号
[cdocno] [varchar] (15) NOT NULL ,	凭证号
[cinput] [varchar] (30) NOT NULL ,	数据原始录入
[cmname] [varchar] (30) NOT NULL ,	经办人
[cmark] [varchar] (15) NOT NULL ,	记录标签
[cmemo] [varchar] (254) NOT NULL ,	记录备注
[ffee] [numeric](18, 2) NOT NULL ,	实际结算费用(应该为零!)
[ffeer] [numeric](18, 2) NOT NULL ,	关联快递业务记录帐单费用
[dsysdate] [datetime] NOT NULL ,	操作发生时间,服务器本地时间
[nstate] [tinyint] NOT NULL ,		处理状态,添加时全为0
[iidoref] [int] NULL ,			处理记录ID,在第三方系统中的记录关联ID,整数,添加时全为NULL
[coref] [varchar] (30) NULL ,		处理记录参考,在第三方系统中的记录关联参考字段,字符串,添加时全为NULL
[dodate] [datetime] NULL 		处理时间,添加时全为NULL


五、cp_oi_settle_add
1、参数
@iidcs		int,			关联客户(icid)/下家(isid)唯一标识
@ikind		tinyint,		结算类别，0：收款 1：回款 2：付款 3：返款
@ffee		numeric(18, 2),		金额
@cinvoice	varchar(22),		发票号
@dpdate	datetime,			结算日期
@cmname	varchar(30),			经办人
@cinput	varchar(30),			数据原始录入
@cmemo	varchar(254),			记录备注
@cdocno	varchar(15),			凭证号
@npayway	tinyint,		结算方式,0:现金 1:转帐 2:网络 3:冲销 4:其它
@crefno	varchar(30),			票证号
@cmark	varchar(15),			记录标签
@caccount	varchar(30)		所走帐户

2、返回值
-1:结算类别不支持
-9:数据库内部错误
>0:添加成功后,记录的ID(ifid,ifsid,ipid,ifcid)


六、cp_oi_settle_mod
1、参数
@iid		int,			记录的ID(ifid,ifsid,ipid,ifcid)
@ikind		tinyint,		结算类别，0：收款 1：回款 2：付款 3：返款
@ffee		numeric(18, 2),		金额
@cinvoice	varchar(22),		发票号
@dpdate	datetime,			结算日期
@cmname	varchar(30),			经办人
@cinput	varchar(30),			数据操作者
@cmemo	varchar(254),			记录备注
@cdocno	varchar(15),			凭证号
@npayway	tinyint,		结算方式,0:现金 1:转帐 2:网络 3:冲销 4:其它
@crefno	varchar(30),			票证号
@cmark	varchar(15),			记录标签
@caccount	varchar(30)		所走帐户

2、返回值
-1:结算类别不支持
-2:记录不存在
-9:数据库内部错误
>0:更新成功后,记录的ID==@iid(参数)


七、cp_oi_settle_del
1、参数
@iid		int,			记录的ID(ifid,ifsid,ipid,ifcid)
@ikind		tinyint,		结算类别，0：收款 1：回款 2：付款 3：返款
@cinput	varchar(30),			数据操作者,将写入系统日志


2、返回值
-1:结算类别不支持
-2:记录不存在
-9:数据库内部错误
>0:删除成功后,记录的ID==@iid(参数)






#-----------------------
上海钮门网络科技有限公司
2009.04.15